Scatter
Scatter image randomly multiple times.
Node Data | |
|---|---|
Display name | |
Scatter | |
Internal name | |
Node_Scatter | |
Inheritances | |
| Node_Processor | |
| Node_Scatter | |
Inputs | |
Output | |
vec2 |
Dimension |
Surfaces | |
surface |
Surface In |
enum |
Array |
iarray |
Array Indices |
surface |
Array Texture |
range |
Animated |
enum |
Animated End |
Scatter | |
Source | |
enum |
Source |
area |
Area |
surface |
Distribution Map |
vec2 |
Points Array |
text |
Extra Value |
enum |
Distribution |
rotRange |
Angle Range |
Amount | |
bool |
Auto Amount |
int |
Amount |
ivec2 |
Uniform Amount |
float |
Distance |
int |
Attempt |
Path | |
path |
Path |
enum |
Spacing |
bool |
Rotate Along Path |
range |
Path Range |
slider |
Path Shift |
float |
Scatter Distance |
Position | |
range2 |
Random Position |
range2 |
Offset Position |
vec2 |
Shift Position |
range |
Shift Radial |
bool |
Exact |
Rotation | |
rotation |
Rotation |
bool |
Point At Center |
rotRand |
Random Angle |
rotRand |
Offset Angle |
rotation |
Rotate Per Radius |
Scale | |
range2 |
Scale |
range2 |
Offset Scale |
range |
Scale Random |
bool |
Uniform Scaling |
vec2 |
Scale Per Radius |
Color | |
gradient |
Random Blend |
range |
Alpha |
bool |
Multiply Alpha |
Sample Color | |
surface |
Sample Surface |
anchor |
Sample Anchor |
range2 |
Sample Wiggle |
Rendering | |
enum |
Blend Mode |
bool |
Sort Y |
toggle |
Tile |
Position | |
Rotation | |
Scale | |
Surface | |
Position | |
Color | |
Atlas | |
Outputs | |
surface |
Surface Out |
atlas |
Atlas Data |
Attributes | |
| Color Depth | |
| Interpolation | |

Scatter surface randomly. To repeat surface in fixed pattern use Repeat node.
Properties
| Surfaces | |
| Array | Choose surface array processing method: - Spread Output: Create multiple surfaces for each surface separately. - Index: Mix all input surfaces using spawn index as array index. - Random: Mix all input surfaces with random array index. - Data: Using third value (if exists) to determine array index. - Texture: Use external surface to select array index. |
| Animated | With surface array connected, increase array index per frame. |
| Animated End | Select what to do when index outside array range. |
| Scatter > Source | |
| Source | Scatter area type. |
| Extra Value | In point array source, apply the third and later values in each data point (if exist) to the given properties. |
| Distribution | Scatter distribution. |
| Amount | |
| Amount | Scatter amount. |
| Distance | In poisson distribution, set minimum distance between each copies. |
| Attempt | In map distribution, set sampling attempt before gives up. |
| Path | |
| Path | Scatter along path. |
| Rotate Along Path | Make the copy rotate along path normal. |
| Path Range | Range of the path to follow. |
| Path Shift | Shift position along path. |
| Scatter Distance | Set random shift distance away from the path. |
| Position | |
| Random Position | Randomly move surface from it's original place. |
| Shift Position | Move surface with fixed amount increase per copy. |
| Shift Radial | Move surface based on its rotation. |
| Exact | Round drawing position to integer. |
| Rotation | |
| Rotation | Base angle. |
| Point At Center | Rotate each copy to face the spawn center. |
| Random Angle | Rotate surface randomly. |
| Scale | |
| Scale | Base scale. |
| Offset Scale | Scale surface randomly in both axis independenly. |
| Scale Random | Scale surface randomly in both axis uniformly. |
| Uniform Scaling | Force the final scaling to have the same value in X and Y axis. |
| Color | |
| Random Blend | Apply random color blending per copy. |
| Alpha | Apply random opacity per copy. |
| Multiply Alpha | Multiply opacity to RGB channel before drawing. |
| Sample Color | |
| Sample Surface | Blend surface based on color sampled from additional surface. |
| Sample Wiggle | Randomly modify sample point. |
| Rendering | |
| Blend Mode | Drawing blend mode. |
| Sort Y | Sort drawing order by it's Y position to create top-down depth effect. |
| Tile | Draw overflow surface to the other side of the surface to create tiling effect. |
Commit History
| 1.21.7.105 |
|
|---|---|
| 1.21.5.002 |
|
| 1.21.5 |
|
| 1.21.4.002 |
|
| 1.21.2.003 |
|
| 1.21.1.0 |
|
| 1.21.0.2.007 |
|
Related Links
- Base Code: /scripts/node_scatter/node_scatter.gml
- Shader [sh_sample]: /shaders/sh_sample/sh_sample.fsh
- Shader [sh_sample_shape]: /shaders/sh_sample_shape/sh_sample_shape.fsh